home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 2 / The Arsenal Files 2 (Arsenal Computer).ISO / lan / aiocub.exe / AIOCUB.TXT next >
Text File  |  1994-06-07  |  19KB  |  451 lines
  1.  
  2.               NOVELL TECHNICAL INFORMATION DOCUMENT
  3.  
  4. TITLE:              Cubix NetWare Connect Driver
  5. DOCUMENT ID:        TID250165
  6. DOCUMENT REVISION:  A
  7. DATE:               06JUN94
  8. ALERT STATUS:       Yellow
  9. INFORMATION TYPE:   Symptom Solution
  10. README FOR:         AIOCUB.EXE
  11.  
  12. NOVELL PRODUCT and VERSION:
  13. NetWare Connect 1.0
  14.  
  15. ABSTRACT:
  16.  
  17. This file contains an AIO driver for the Cubix MP2008 Multiport Communications
  18. Board (certified for NetWare Connect).
  19.  
  20. ──────────────────────────────────────────────────────────────────────────────
  21. DISCLAIMER
  22. THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR EXTERNAL TO NOVELL.  NOVELL
  23. MAKES EVERY EFFORT WITHIN ITS MEANS TO VERIFY THIS INFORMATION.  HOWEVER, THE
  24. INFORMATION PROVIDED IN THIS DOCUMENT IS FOR YOUR INFORMATION ONLY.  NOVELL
  25. MAKES NO EXPLICIT OR IMPLIED CLAIMS TO THE VALIDITY OF THIS INFORMATION.
  26. ──────────────────────────────────────────────────────────────────────────────
  27.  
  28. SYMPTOM
  29.  
  30. Problems occur when using the Cubix MT2008 multi-port communications board
  31. with NetWare Connect.
  32.  
  33. SOLUTION
  34.  
  35. Apply AIOCUBIX.NLM.
  36.  
  37. Self-Extracting File Name: AIOCUB.EXE
  38.  
  39. Files Included     Size     Date
  40.  
  41. AIOCUBIX.NLM        17280          12-10-93
  42. AIOCUB.TXT      ( This File )
  43.  
  44. Installation Instructions:
  45.  
  46. NOTE: This driver is supplied by Cubix.  If you have questions about it,
  47. please contact Cubix.
  48.  
  49. Copy AIOCUBIX.NLM to SYSTEM:SYS directory.
  50.  
  51. =======================================
  52. Hardware Configuration
  53.  
  54.   The MP2008 has a single switch bank labelled SW1 on the top edge of the
  55. adapter, near the end bracket.  This switch bank consists of eight switches,
  56. numbered one through 8.  These switches should only be changed while the
  57. system in which the MP2008 is located is powered off.  A switch is in the ON
  58. position when it is toward the board.
  59.  
  60.           DEFAULT is ALL ON or TOWARD THE BOARD
  61.  
  62. _______________________________________
  63. Base I/O Address Selection
  64.  
  65.   The switches in bank SW1 set the I/O port address and the logical board
  66. number to be used by the MP2008.  Switches 1 and 2 control the I/O port
  67. address, while switches 4-8 control the logical board number.  Switch 3 is
  68. always ON.
  69.  
  70.   The MP2008 requires a series of 16 I/O locations to allow communications
  71. between the software driver provided and the hardware.  Switches 1 and 2 set
  72. the base I/O address to be used for this I/O address range.  The MP2008
  73. supports four different I/O address ranges (numbers given in hexadecimal):
  74.  
  75.      Base I/O Address    Range     Switch 1  Switch 2
  76.  
  77.      default   200       200-20F   ON        ON
  78.                210       210-21F   ON        OFF
  79.                300       300-30F   OFF       ON
  80.                310       310-31F   OFF       OFF
  81.  
  82. 1.  Select any base I/O address that does not conflict with other system
  83. hardware.  If a base I/O address other than the default is selected, this
  84. address must be specified using a command line option when the MP2008's AIO
  85. driver is loaded.  See the Software Installation and Configuration section.
  86.  
  87. 2.  ALL MP2008 BOARDS IN YOUR SYSTEM MUST USE THE SAME BASE I/O ADDRESS. 
  88. Furthermore, I/O addresses used by the MP2008 must not conflict the I/O
  89. addresses in use by any other system hardware.
  90.  
  91. _______________________________________
  92. Logical Board Number Selection
  93.  
  94. 1.  Each MP2008 board installed in a server must be assigned a unique board
  95. number among all MP2008 boards in that system.  The logical board number is
  96. used (along with a port number) to identify individual ports when the software
  97. driver is loaded.  If two MP2008 adapters attempt to utilize the same logical
  98. board number, driver failures will result.
  99.  
  100. 2.  Any board number from zero to fifteen may be selected for use by a board. 
  101. Cubix recommends that boards be assigned numbers sequentially, beginning with
  102. board number zero.  Switch bank SW1 switches 4-8 are used to set the board
  103. number for the hardware.  The MP2008 software dynamically detects the board
  104. numbers that are selected, so there are no command line options for board
  105. number specification for the MP2008 driver.  The switch settings for the
  106. logical board number are the following:
  107.  
  108.                                 Switch Settings
  109.         Logical Board    SW4  SW5  SW6  SW7  SW8
  110.  
  111. default         0        ON   ON   ON   ON   ON
  112.                 1        ON   ON   ON   ON   OFF
  113.                 2        ON   ON   ON   OFF  ON
  114.                 3        ON   ON   ON   OFF  OFF
  115.                 4        ON   ON   OFF  ON   ON
  116.                 5        ON   ON   OFF  ON   OFF
  117.                 6        ON   ON   OFF  OFF  ON
  118.                 7        ON   ON   OFF  OFF  OFF
  119.                 8        ON   OFF  ON   ON   ON
  120.                 9        ON   OFF  ON   ON   OFF
  121.                10        ON   OFF  ON   OFF  ON
  122.                11        ON   OFF  ON   OFF  OFF
  123.                12        ON   OFF  OFF  ON   ON
  124.                13        ON   OFF  OFF  ON   OFF
  125.                14        ON   OFF  OFF  OFF  ON
  126.                15        ON   OFF  OFF  OFF  OFF
  127.  
  128. _______________________________________
  129. Board Installation
  130.  
  131. 1.  Before installation of the MP2008, be sure to turn the system off and
  132. disconnect it from the power source.  Inserting the MP2008 into a live
  133. computer may damage the MP2008 hardware and may severely injure you.
  134.  
  135. 2.  The MP2008 must be installed in a 16 bit ISA or 32 bit EISA compatible
  136. slot.  Be sure to observe the overall system power requirements for the hosts
  137. hardware configuration.
  138.  
  139. 3.  After installing the MP2008 in an available slot, be sure to use a screw
  140. to secure the edge connector of the MP2008 to the system chassis.  Firm
  141. installation of the adapter board helps to ensure that loose connections do
  142. not cause system unreliability or damage to the hardware.
  143.  
  144. 4.  Next, connect the provided MP2008 communications cable to the MP2008
  145. board.  IT IS VERY IMPORTANT THAT THE HOLD DOWN SCREWS ON THE CONNECTOR BE
  146. FIRMLY ATTACHED TO THE MP2008 ADAPTER BOARD.  Failure to observe this
  147. requirement often results in misalignment of the connector, and intermittent
  148. communications signals that can cause abnormal communications session loss (or
  149. inhibition of communications altogether).
  150.  
  151. 5.  Be sure to double check the installation and configuration of the MP2008
  152. hardware before powering on the system or proceeding to software installation
  153. and configuration.
  154.  
  155. =======================================
  156. Software Installation and Configuration
  157.  
  158. _______________________________________
  159. How to install and configure the MP2008 software.
  160.  
  161.   The MP2008 Multiport Communications Adapter includes an AIO software driver
  162. that executes as a NetWare Loadable Module (NLM) in a Novell NetWare server. 
  163. This NLM, "AIOCUBIX.NLM", is loaded like other NLMs, with the server software.
  164.  
  165.   The MP2008 driver checks for hardware base I/O address conflicts with other
  166. types of hardware in its host system.  If a conflict is detected, a prompt
  167. will ask for another selection.  Remember to set the hardware switch settings
  168. using switches 1 and 2 of switch bank SW1 to match the selected software
  169. options.
  170.  
  171. _______________________________________
  172. Loading the Software using the Default Hardware Configuration
  173.  
  174.   Using the default hardware configuration (all switches in the ON position),
  175. means that no command line options are necessary to load the AIO driver.  To
  176. load the NLM in this configuration, issue the following command to your
  177. NetWare server:
  178.  
  179.           LOAD AIOCUBIX
  180.  
  181.   The driver name, version, and date are displayed.
  182.  
  183.   The AIO driver attempts to locate all MP2008 boards in the system using the
  184. default I/O address.  As each board is located, a message is displayed that
  185. indicates the self test results and whether the board was successfully loaded.
  186. If all boards do not load successfully, check the I/O base address settings
  187. and refer to the Troubleshooting section of the card's documentation.
  188.  
  189.   If all boards pass the self test and are successfully loaded, the MP2008
  190. driver loads and the MP2008 is ready for use.
  191.  
  192.   AIO requires that boards be numbered starting from zero and that all boards
  193. using an individual driver have contiguous numbers.  Therefore, include a
  194. "node=" parameter on the command line.  If it is not included, AIO will not
  195. find the board or the ports on that board.
  196.  
  197.   For example:
  198.  
  199.      LOAD AIOCUBIX NODE=0
  200.  
  201.   This will set the board number for this invocation of the driver to zero. 
  202. Succeeding load commands for the driver require "node=1", "node=2" ...
  203.  
  204. _______________________________________
  205. Using Non-default Base I/O Address Configurations
  206.  
  207.   If non-default settings for the I/O base address are selected (as described
  208. in section 2.1), they must be specified when you load the AIOCUBIX.NLM driver.
  209. Use the command:
  210.  
  211.           LOAD AIOCUBIX PORT=<base I/O address>
  212.  
  213.      where <base I/O address> is "200", "210", "300", or "310", corresponding
  214. to the settings for switches 1 and 2 of switch bank SW1.  Alternatively, the
  215. <base I/O address> may be omitted, including only the parameter "PORT=", the
  216. operator will be prompted with valid I/O addresses.  I/O addresses already in
  217. use by other components in the system are not included in the valid options
  218. list.
  219.  
  220.   ALL MP2008 BOARDS IN THE SYSTEM MUST USE THE SAME BASE I/O ADDRESS. 
  221. Furthermore, I/O addresses used by the MP2008 must not conflict the I/O
  222. addresses in use by any other hardware in the system.
  223.  
  224. _______________________________________
  225. Board Names
  226.  
  227.   The MP2008 board automatically sets a default board name of "MP2008."  To
  228. override this name and specify a name, use the command line option
  229. "NAME=<board name>".  For example, the following command line establishes
  230. MP2008 boards using the name "MY_NAME":
  231.  
  232.           LOAD AIOCUBIX  NAME=MY_NAME
  233.  
  234.   Cubix recommends using the default board name for the MP2008.
  235.  
  236. _______________________________________
  237. Unloading the MP2008 Driver from Memory
  238.  
  239.   The MP2008 AIO driver may be unloaded from server memory using the following
  240. command:
  241.  
  242.           UNLOAD AIOCUBIX
  243.  
  244.   There are no options for the unload command.  Be sure to close any active
  245. connections before unloading the MP2008 driver.
  246.  
  247. _______________________________________
  248. Command Line Help
  249.  
  250.   An on line description of command line options is available for the MP2008
  251. AIO driver.  To view this command usage information, use the following
  252. command:
  253.  
  254.           LOAD AIOCUBIX HELP
  255.  
  256.   Note that the driver is not loaded if command help is requested. The driver
  257. must be loaded  as described in this chapter.
  258.  
  259. _______________________________________
  260. Verifying that the Driver has Loaded Successfully
  261.  
  262.   In addition to the messages printed on the system console, the MP2008
  263. provides a rear panel indicator lamp, visible through the bracket, that may be
  264. used to confirm that the driver has loaded successfully.  The lamp states are:
  265.  
  266.   OFF SOLID
  267.   - indicates that the driver is not present, that is, it has not yet been
  268. loaded, or that it has been unloaded.
  269.  
  270.   ON/OFF FLASHING
  271.   - indicates that the driver is present and operating normally.
  272.  
  273.   ON SOLID
  274.   - indicates that the board failed self-test or that the software load was
  275. unsuccessful.
  276.  
  277.   If the lamp is in the solid-ON state, consult the troubleshooting section
  278. for assistance in identifying the problem.
  279.  
  280. Patch History:
  281.  
  282. This is the first driver posted in the NetWire Library for the Cubix MP2008
  283. Multiport Communications Board.
  284.  
  285. Solution Specifics:
  286.  
  287. The Cubix MP2008 Multiport Communications Board is a PC-AT form factor, ISA
  288. bus, state-of-the-art combination of high speed controller and UARTs that
  289. offers system administrators fast and reliable shared serial resources for
  290. "port controlled" networks.
  291.  
  292. Using multiple MP2008 boards in a NetWare Connect or Cubix Connect
  293. communications system allows the system administrator to manage a "port pool"
  294. of simultaneous dial-in and/or dial-out asynchronous connections.
  295.  
  296. Up to sixteen MP2008 adapters may be placed in a single system, provided
  297. sufficient slots and power are available.  The MP2008 requires a single 16-bit
  298. ISA slot for each adapter.
  299.  
  300. Connect communicates with the MP2008 via a supplied software driver AIOCUBIX,
  301. that provides an AIO (Asynchronous Input/Output) interface to various
  302. applications.  This driver is loaded in a Novell NetWare or RunTime NetWare
  303. server, and provides the software interface for access to the MP2008 ports.
  304.  
  305. The heart of the MP2008 is the 20MHz 80C286 processor with optimized code to
  306. move data between Connect and the 16550 class UARTs quickly enough to keep the
  307. ports operating at their full 115Kbps rating. The 16C550 UARTs with 16 byte
  308. buffers ensure that there will be no overruns or missed characters at full
  309. rated speed.
  310.  
  311. The MP2008 is provided with an octopus cable with a 78 pin connector on the
  312. MP2008 end and eight 6 foot long cables terminating in DB-25 male "D"
  313. connectors, wired as Data Terminal Equipment (DTE), for connection to external
  314. RS-232 compatible devices such as modems, multiplexers and mainframe terminal
  315. ports.
  316.  
  317. _______________________________________
  318. 1.1  Theory of Operation
  319.  
  320.   NetWare Connect operates as a enhanced subset of Novell's file server
  321. software.  NetWare Connect consists of core elements of the file server
  322. software, the NetWare Core Protocol (NCP), supplied as "Runtime NetWare", to
  323. support non file server services in the form of NetWare Loadable Modules
  324. (NLMs), and the Connect NLMs.
  325.  
  326.   Connect NLMs provide security and form the virtual links between a NetWare
  327. service, such as Remote Node Service (RNS) and IPX, or NASI Connection
  328. Services (NCS) and the outside world via an Asynchronous Input/Output (AIO),
  329. module.
  330.  
  331.   The MP2008 and its associated NLM driver, AIOCUBIX, form the actual
  332. Input/Output hardware/software module that moves data to/from the network
  333. under control of the Connect software.
  334.  
  335.   The Connect software moves data to/from the MP2008 board(s) via the ISA bus
  336. as a two byte "programmed I/O" data transfer using a dual ported RAM data
  337. buffer and "mailbox" on the MP2008 located at a defined Connect I/O port
  338. address. This dual ported RAM has, for each of the 8 ports:
  339.  
  340.   8KByte buffers for transmit and receive data and "mailbox" area for status
  341. and control information.
  342.  
  343.   The MP2008 80C286-20MHz CPU moves data and control/status information
  344. to/from the UARTs and the Connect host CPU through the dual ported buffer RAM.
  345.  
  346. _______________________________________
  347. Appendix A - Specifications
  348. Software:
  349. Software Interface: AIO (as an NLM), name=AIOCUBIX.NLM
  350. Unloadable:    yes
  351. Bit rates:          50, 75, 110, 134.5, 150, 300, 600, 1200,
  352.                1800, 2000, 2400, 3600, 4800, 7200, 9600,
  353.                19200, 38400, 57600, 115200 (bits per second)
  354. Word lengths:  5, 6, 7, and 8 bits
  355. Stop bits:          1, 1.5, 2 (as appropriate for word length)
  356. Parity types:  none, even, odd, mark, space
  357. Flow control types: none, hardware (RTS/CTS),
  358.                     software (Xon/Xoff),
  359.                     hardware and software
  360. Port deadman timers supported
  361. RS-232 break signal generated and detected
  362. Firmware:      dynamically loaded from driver software
  363.  
  364. Hardware:
  365. CPU:           80C286 (20 Mhz)
  366. UARTs:4 each,  16C552 (dual port)
  367.      Receive buffer:     16 Byte FIFO
  368.      Transmit buffer:    16 Byte FIFO
  369.      Number of ports:    eight total, asynchronous, RS-232
  370. RS-232 connectors:  25-pin male D-connectors, via octopus cable
  371. RS-232 signals:     TxD, RxD, RTS, CTS, DSR, Gnd, DCD, DTR, RI
  372. System bus:         16-bit ISA slot; full length, AT form factor
  373. System bus data rate:    4MBytes per second (32 Mbits per second)
  374.                          8MHz bus, zero wait states
  375. Read buffers:  eight, (8191 bytes), SRAM, hardware assisted wrap
  376. Write buffers: eight, (8191 bytes), SRAM, hardware assisted wrap
  377. Mailbox buffer:     one (16k bytes) SRAM (read buffers, write buffers,
  378. mailbox: dual ported)
  379. Local program memory     16k bytes, zero wait states
  380. System interface:   dual port memory, via pre-fetched and post written I/O
  381. mapped port access
  382. Supported I/O ranges     200-20F, 210-21F, 300-30F, 310-31F (one required)
  383. IRQs required: none
  384. Memory ranges required:  none
  385. DMA lines required: none
  386. Power requirements: 2.0a   +5 volts
  387.                0.2a  +12 volts
  388.                0.2a  -12 volts
  389. FCC certifications: Class A
  390. Temperature:   0 to 40 degrees Centigrade (operation)
  391.                0 to 70 degrees Centigrade (storage)
  392. Humidity:      10 to 95% (non-condensing)
  393.  
  394. _______________________________________
  395. Appendix B - Cable Specifications
  396.  
  397. B.1 RS-232 Cable Pinouts
  398.  
  399. The Cubix MP2008 includes an "octopus" shielded cable that converts the 78-pin
  400. high density connector on the adapter to eight DB-25 male RS-232 D-connectors.
  401. All ports are wired as the DTE interface.  The pinouts for the RS-232
  402. connections are standard:
  403.   1 - chassis ground
  404.   2 - transmit data      (TxD) Transmit Data - output
  405.   3 - receive data       (RxD) Receive Data - input
  406.   4 - Request To Send    (RTS) Ready To Send - output
  407.   5 - Clear To Send      (CTS) Clear To Send - input
  408.   6 - Data Set Ready     (DSR) Data Set Ready - input
  409.   7 - signal ground      (GND) Ground
  410.   8 - Data Carrier Detect     (DCD) Data Carrier Detect - input
  411.  20 - Data Terminal Read (DTR) Data Terminal Ready - output
  412.  22 - Ring Indicator          (RI)  Ring Indicate - input
  413.  
  414. Leads denoted as "output" are outputs from the MP2008.  Conversely, leads
  415. denoted as "input" are inputs to the MP2008.  All other pins are "No Connects"
  416.  
  417. B.2 Connection to Modems
  418.  
  419. Because modems are DCE devices and the MP2008 provides a DTE interface, a
  420. straight-through cable is sufficient to connect a modem to the MP2008.  At a
  421. minimum, connections should be provided on the leads noted in section B.1
  422. above.  Connections on all 25 leads are acceptable.
  423.  
  424. B.3 Connection to Hosts, Workstations, PCs, or Terminals
  425.  
  426. Direct connection of the MP2008's RS-232 ports to hosts, workstations, PCs, or
  427. terminals configured as DTE equipment (without a intermediate modem or DCE
  428. device) generally requires a "null modem" cable. A "null modem" cable is so
  429. called, because it eliminates the need for modems (DCE devices) by crossing
  430. RS-232 signal pairs between the two DTE devices, such that each "sees" the
  431. other as a DCE device.
  432.  
  433. To make a "null-modem" cable, use the following connections:
  434.  
  435.          MP2008 side            other DTE side
  436.              2  ---------------------  3
  437.              3  ---------------------  2
  438.              4  ---------------------  5
  439.              5  ---------------------  4
  440.              7  ---------------------  7
  441.              6  -----|---------------  20
  442.              8  -----|
  443.             20  ---------------|-----  6
  444.                                |-----  8
  445.  
  446. ----------------------------------------------------------------
  447. Any trademarks referenced in this document are the property of their
  448. respective owners.  Consult your product manuals for complete trademark
  449. information.
  450. ----------------------------------------------------------------
  451.